home *** CD-ROM | disk | FTP | other *** search
/ QRZ! Ham Radio 4 / QRZ Ham Radio Callsign Database - Volume 4.iso / files / amiga / cdoc720j.lzh / fx.doc < prev    next >
Encoding:
Text File  |  1993-08-25  |  2.6 KB  |  55 lines
  1. fx is a program that allows you to send a command to SYSOP via AREXX and
  2. it will save the output from that command into a specified file.
  3. The reason this program is needed is because I cannot get the AREXX GETARG()
  4. function to work with the rexxhost.library that I am using to handle the
  5. AREXX calls for me. I can make an AREXX script send a string to another
  6. AREXX script which receives it using GETARG(). But if I send that same
  7. script a string from SYSOP, it gives an Illegal Argument error in the
  8. GETARG() function.
  9.  
  10.    Until I can find out why this fails and can fix it, the fx program can do
  11. almost the same thing for you. In order to use this program the prompt in
  12. your 'sysop' program MUST be 'SYSOP>'. The fx program uses the 'SYSOP>' to
  13. detect when the output from the command has finished. Usage is as follows:
  14.  
  15.    fx filename c-bbs_command argument(s)
  16.  
  17.    The filename is the name of the file where the output from SYSOP is to be
  18. stored and the rest of the arguments are whichever C-BBS command you want
  19. to have executed. Only one command can be done at a time.
  20.  
  21.    'fx' sends the 'GO' command to SYSOP (which MUST be IDLE at the time)
  22. and then it sends the command argument and saves all output up to but NOT
  23. including the next SYSOP> prompt. Once that is done, it sends a 'B'ye
  24. command to sysop to make it IDLE again. As an example, if you want a listing
  25. of all AMSAT bulletins to be stored in the file ram:amsat.out then use the
  26. command
  27.  
  28.    fx ram:amsat.out l@ amsat
  29.  
  30.    Note that you do not have to put quotes around the  l@ amsat  command.
  31. However, if the command you are sending contains any characters that mean
  32. something to AREXX or amigados, it is safest to enclose the whole command in
  33. quotes. For example:
  34.  
  35.    fx ram:amsat.out "l@ amsat ;"
  36. or
  37.    fx ram:amsat.out l@ amsat ";"
  38.  
  39. will do the same thing.
  40.  
  41.    The fx program takes all arguments after the filename and collects them
  42. into one string putting spaces between each argument. The above examples will
  43. therefore send the command "l@ amsat ;" to sysop. The output will not include
  44. the initial or final SYSOP> prompts, but it will include the title line that
  45. is part of the output from the 'L' commands. Your AREXX script must take
  46. this into account and skip this line. See the sample AREXX script which does
  47. just that (fx.rexx).
  48.  
  49.    There is one restriction you should heed. Not all C-BBS commands output a
  50. whole line at a time. Some of them print part of a line and then individual
  51. characters. The FX program cannot be used to capture this output. I will try
  52. to fix this problem. I expect that the main use of this program will be to
  53. capture the output of the List command which always outputs a whole line at
  54. a time.
  55.